home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / fishsub.zip / FISHSUB.DOC < prev    next >
Text File  |  1992-01-15  |  21KB  |  586 lines

  1.  
  2.  
  3.                                    ██  ██
  4.                       ■■■██       ▄██  ██▄
  5.                  ▄▄▄▄▄▄▄████▄▄▄▄▄▄████████▄▄▄▄▄▄▄▄▄▄▄▄▄
  6.                   ▀▀█████████████████████████████████▀
  7.                      ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  8.  
  9.                                  ▐
  10.                                 ▌▐
  11.                                █▀▀█
  12.                                █  █
  13.            ▄─▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀─▀  ▀─▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀─▄
  14.         ▄▄▀   Θ  « Fish Sub »                           █▄▄█▄
  15.         ▀▀▄   Θ                                         █▀▀█▀
  16.            ▀─▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄─▀
  17.  
  18.  
  19.  
  20.                            V e r s i o n 5.0
  21.  
  22.                          Written By: Jim Toomes
  23.                          Bensalem, Pennsylvania
  24.  
  25.                               Bensalem BBS
  26.                              (215) 752-4009
  27.                                  2 Nodes
  28.                             300/1200/2400/bps
  29.  
  30.  
  31.                            (C)opyright 1990-92
  32.  
  33.  
  34.  
  35.                               Warranty
  36.  
  37.     This product is provided "as is" without warranty of any kind.
  38.     The entire risk as to the results and performance of the program
  39.     is assumed by you.  Further more, I the author do not warrant,
  40.     guarantee, or make any representations regarding the use of or
  41.     the results of the use of the program, and you rely on the
  42.     program and results solely at your own risk.  I the author cannot
  43.     accept responsibility for system damage, loss of profit, or any
  44.     other special, incidental, or consequential damages resulting
  45.     from the use or inability to use this product.
  46.  
  47.  
  48.  
  49.                               Copyright
  50.  
  51.     The FISH SUB door game is distributed as SHAREWARE.
  52.     Under this concept you may use the SHAREWARE (unregistered)
  53.     version for a reasonable period of time, which I consider to
  54.     be three weeks, after which you must either register your
  55.     copy or discontinue usage.  Note: This unregistered game will
  56.     expire sometime in the future.
  57.  
  58.  
  59.  
  60.                       THANKS TO THE FOLLOWING:
  61.  
  62.     I am deeply indebted for the participation in the beta testing
  63.     of Fish-Sub.
  64.  
  65.     Walter Minnichbach, Walt and Kathy's BBS,
  66.     (215)-547-6672, Levittown, Pa.
  67.  
  68.                               Registration
  69.  
  70.     With registration you will receive the latest registered
  71.     copy of FISH-SUB with the ability to download any further
  72.     updates from the Bensalem BBS at no extra cost.  I don't
  73.     write a game and forget about it.  Any new ideas from you
  74.     or myself may be implemented towards further updates.  You
  75.     will also receive any support the author can give in reference
  76.     to bugs or other problems that may arise in using this game.
  77.  
  78.  
  79.  
  80.     I feel that SysOp's have enough expense without charging a
  81.     high cost for a game for their users.  I have set the cost of
  82.     registration at $15.00 to download your registered copy from
  83.     my board or $15.00 + $2.50 by mail for shipping and handling
  84.     which I feel if people will follow the shareware concept will
  85.     be enough to encourage me to write more door games.  See the
  86.     registration form at the end of this document for ordering
  87.     instructions.
  88.  
  89.  
  90.  
  91.                               Distribution
  92.  
  93.     You are free, in fact encouraged to distribute the SHAREWARE
  94.     (unregistered) version of the FISH SUB door game, provided
  95.     that all files contained in the original FISH SUB archive
  96.     are distributed in their original unmodified state.
  97.  
  98.  
  99.  
  100.                               How To Play
  101.  
  102.                            & The Fish Sub &
  103.  
  104.     Fish Sub is a game of hide and seek, the enemy hides and
  105.     you seek.  The game is made up of 122 sectors with an
  106.     enemy sub, 3 enemy decoys, 20 enemy mines, and a subchaser.
  107.  
  108.     The player is the subchaser and it's job is to sink the
  109.     enemy Fish Sub without running out of fuel.  One hit can
  110.     sink either side.  To fire a depth charge, select
  111.     the coordinates 0 thru 10.
  112.  
  113.     Mines are tricky, they may explode on you or near
  114.     you, taking points from you.  If you find the decoy
  115.     submarine, this will give you 600 points.  Finding
  116.     two decoy submarines will give you a bonus of 3 extra turns.
  117.     Destroying the Fish Sub will give you 1000 points
  118.     Losing the game will take a 1000 points from you.
  119.     The Fish Sub will detect your movements and will take turns
  120.     or points from you if it attacks you.  Fish Sub also will
  121.     move toward or away from you on its horizontal plane.
  122.  
  123.     The Subchaser has on board a scanner that readsout compass
  124.     directions of where the Fish Sub may be.  North and South
  125.     are not exact, but your East and West is right on.  For
  126.     example, the scanner may readout Fish Sub is North of you,
  127.     this is anywhere north of you.  The scanner may readout
  128.     Fish Sub is West of you, your right on, stay on this
  129.     horizontal.  The scanner will detect the fish sub decoy(s)
  130.     when within one sector of you by a 360 degree pattern.
  131.  
  132.     The scanner can malfunction at times and will take a couple
  133.     turns to repair it.
  134.  
  135.     Player will start with 15 turns.  Getting your name listed
  136.     on the score bulletin is easy if you have enough fuel
  137.     before destroying the Fish Sub.  Turns = Fuel, Points = Speed.
  138.  
  139.     When a player is one of the Top Ten Players on the score
  140.     board, a different menu will show giving that player access to
  141.     many more features.
  142.  
  143.     One feature is entering his or her own Fish Sub coordinates.
  144.     The player's information will be deleted if the fish sub is
  145.     found by another player.
  146.     When another player plays a player and did not find the Fish
  147.     Sub at the end of the game, the target player will receive
  148.     1000 points for not losing his or her fish sub.
  149.  
  150.     Destroying the Fish Sub will cause the target player to
  151.     receive -1000 points and will delete his or her old coordinates.
  152.     New coordinates must be reinstalled by the top player(s).
  153.  
  154.     You can view the daily newspaper which keeps track of the
  155.     events, player against player.  Playing against the computer
  156.     will not be recorded.
  157.  
  158.     Good luck and good hunting!
  159.  
  160.  
  161.  
  162.                            Sysop Information
  163.  
  164.     This program is written and compiled in Microsoft 'C' V 6.0.
  165.  
  166.     I use the LiveCat Program written by Steve Cox to control all
  167.     my door games.  Give it a try.
  168.  
  169.     FISH SUB door game will create a very nice mono top 10 bulletin
  170.     and write it in the directory of your choice written in the
  171.     .CFG file.  The top 10 bulletin will show the Names and the
  172.     Scores who made the top 10.  The bulletin will also show the
  173.     total times the game was played.  Each new month the bulletin
  174.     will clear itself of the old information and write the number
  175.     one player of the month to the bulletin.
  176.  
  177.     If you are watching the monitor screen at that time, a local
  178.     message is written to the screen confirming the new month change.
  179.     This local message cannot be seen by the remote player.
  180.  
  181.     FISH SUB will time out with no activity and detect dropped
  182.     carrier.
  183.  
  184.     Your BBS name will write to the main menu via the config
  185.     file,(.CFG).  The logic for the FISH SUB game is written
  186.     to allow the player to win as well as losing.
  187.  
  188.     Local game playing can be done with all FISH SUB files in the
  189.     same directory and the .CFG file completed.  Just type the name
  190.     of this game, FISHSUB LOCAL.  The fishsub.exe and fishsub.cfg
  191.     must be together to run locally.  Be sure that you have the
  192.     correct paths indicated in the .CFG file, if no path for the
  193.     score file, type in NONE.  Incorrect paths may cause the program
  194.     to write out an error to ya'.  Like Huh!! or some type of error
  195.     message.
  196.  
  197.     If you need to refresh all the files or update the game to a new
  198.     start before the end of the month, just erase the datef.dat file
  199.     and start the game.  Or at the end of the month it does all of
  200.     that for you.
  201.  
  202.     When the newspaper file reaches two pages long, the file
  203.     will erase itself or at the end of the month whichever comes 
  204.     first.  No need for the SysOp to worry about maintaining files.
  205.  
  206.     When a player enters the fishsub game for the first time, the
  207.     top player main menu will not show to that player until his or
  208.     her name is listed on the score board.
  209.     This means after the player signs off from the game and enters
  210.     back in with his or her name already listed.
  211.  
  212.     If the new player cannot get on the score board (ten names
  213.     already listed) that new player will not be allowed to enter
  214.     their fishsub coordinates, but they can play any name listed.
  215.  
  216.     Entering his or her fishsub and three decoy coordinates.
  217.     Any number from 0 to 10 can be entered, one number each per
  218.     entry for a total of two entries would be one complete entry.
  219.  
  220.     For example;
  221.     (1) Fishsub, type the First number & press enter:
  222.     (you would type in any number from 0 to 10).
  223.  
  224.     (1) Fishsub, type the First number & press enter: 10
  225.     (1) Fishsub, type the Second number & press enter: 5
  226.  
  227.     (2) Decoy1, type the First number & press enter: 3
  228.     (2) Decoy1, type the Second number & press enter: 0
  229.  
  230.     (3) Decoy2, type the First number & press enter: 7
  231.     (3) Decoy2, type the Second number & press enter: 9
  232.  
  233.     (4) Decoy3, type the First number & press enter: 8
  234.     (4) Decoy3, type the Second number & press enter: 1
  235.  
  236.                              Done!
  237.  
  238.     The mines are configured from the numbers you have selected
  239.     and will automatically be installed.  You just have to plan your
  240.     fishsub and three decoy entries.
  241.  
  242.     You can use the same number more than once, but you will
  243.     get better results by using individual numbers.
  244.  
  245.     You can view the locations of your fishsub, decoys, and mines.
  246.     If you don't like the results, go back and start over.
  247.  
  248.     (Any suggestions please drop me a line).
  249.  
  250.     Good luck and enjoy!
  251.  
  252.  
  253.     Note:  The unregistered copy will not make or write an external
  254.     score bulletin or play all 10 players, only the registered copy
  255.     will.
  256.  
  257.  
  258.                               Installation And Setup
  259.  
  260.     The archive package you downloaded contains the Shareware
  261.     version of FISH SUB and should contain the following files,
  262.     except for the ones that are made from the main program.
  263.     '*' Indicates the files you should have.
  264.  
  265.          FISHSUB.EXE   -- * Executable Program.
  266.  
  267.          FISHSUB.CFG   -- * Sample Configuration file.
  268.  
  269.          FISHSUB.DAT   --   Made from the Executable Program.
  270.                             Keeps record of username, date,
  271.                             and score.
  272.  
  273.            DATEF.DAT   --   Made from the Executable Program.
  274.                             Updates the champion of the month
  275.                             and resets the fishsub.dat, namef.dat,
  276.                             "name".ddd, ftcount.dat, log.dat, starts
  277.                             the fdturn.bat file for a fresh start.
  278.  
  279.            NAMEF.DAT   --   Made from the Executable Program.
  280.                             Stores the champion of the month.
  281.  
  282.           "NAME".DDD   --   Made from the Executable Program
  283.                             Stores player information.
  284.  
  285.           DFTURN.BAT   -- * The main program calls this batch
  286.                             file and deletes all the *.DDD
  287.                             files for the new month change.
  288.  
  289.          FTCOUNT.DAT   --   Made from the Executable Program.
  290.                             Records the total times the game was
  291.                             played.
  292.  
  293.          TOPLAYER.DAT  --   Made from the Executable Program.
  294.                             Records the toplayer information.
  295.  
  296.          TOPNAME.DAT   --   Made from the Executable Program.
  297.                             Records the toplayer information.
  298.  
  299.           BULL##.BBS   --   Made from the Executable Program.
  300.                             Nice mono bulletin display.
  301.  
  302.         INSTRUCT.DOC   -- * Documentation viewed from the game.
  303.                             Part of game.
  304.  
  305.          INSTRUC.DOC   -- * Documentation viewed from the game.
  306.                             Part of game.
  307.  
  308.          FISHSUB.DOC   -- * This file you are now reading.
  309.  
  310.         CFGMAKER.EXE   -- * The cfgmaker is a simple utility
  311.                             to help you make the FISHSUB.CFG file.
  312.                             You don't have to use the cfgmaker,
  313.                             whatever is easier for you.
  314.  
  315.         CFGMAKER.DOC   -- * Explains how to use the CFGMAKER.
  316.  
  317.         PRINTDOC.EXE   -- * The printdoc will print the fishsub.doc
  318.                             to your printer.  Again you don't have to
  319.                             to use the printdoc, whatever is easier
  320.                             for you.
  321.  
  322.                             You can delete the files FISHSUB.DOC,
  323.                             CFGMAKER.EXE, and PRINTDOC.EXE if you
  324.                             don't want to save them.
  325.  
  326.     If any of the files are missing you can obtain the latest
  327.     Shareware version of FISH SUB by calling Bensalem BBS in
  328.     Bensalem, Pennsylvania at 215-752-4009 300/1200/2400/bps.
  329.     I know Bensalem ain't the end of the world, but you can see
  330.     it from here.
  331.  
  332.  
  333.  
  334.     The FISH SUB game is set up to work on a Multi Board
  335.     interface.  That means that with one simple change in the .CFG
  336.     file, it can run on the following BBS systems.
  337.  
  338.               Wildcat 1.10, 1.11, 1.12, 1.13, 2.0+, 3.0+.
  339.               PCBOARD 12.x and 14.x.
  340.               GAP 3.x .
  341.               Spitfire 2.5+.
  342.  
  343.     In order to setup for any of the above board types, two lines
  344.     in the .CFG must be considered.
  345.  
  346.     LINE #6, this line tells your game the name of the callers
  347.     information file produced by the BBS itself and may be any
  348.     of the following.
  349.  
  350.       NOTE: Use the GP for the Wildcat 3.0+.
  351.  
  352.               C:\WILDCAT\CALLINFO.BBS
  353.               C:\WC30\DOOR.SYS
  354.               C:\GAP\DOOR.SYS
  355.               C:\PCB\PCBOARD.SYS
  356.               C:\SF\SFDOORS.DAT
  357.  
  358.     LINE #8, This line tells the game what BOARD TYPE it is
  359.     translating.
  360.  
  361.  
  362.       LINE #8;                                LINE #6;
  363.  
  364.       W1 = WILDCAT 1.10 OR 1.11    -=
  365.                                            =- CALLINFO.BBS
  366.       W2 = WILDCAT 1.12 OR 2.0+    -=
  367.  
  368.  
  369.       GP = WC30+                   -=      =- DOOR.SYS
  370.  
  371.  
  372.       P2 = PCBOARD 12.X            -=
  373.                                            =- PCBOARD.SYS
  374.       P4 = PCBOARD 14.X            -=
  375.  
  376.  
  377.       SF = SPITFIRE 2.5+           -=      =- SFDOORS.DAT
  378.  
  379.  
  380.       GP = GAP 3.X AND 4.X         -=      =- DOOR.SYS
  381.  
  382.       NOTE: Use the GP for the Wildcat 3.0+.
  383.  
  384.     These paths must match the actual configuration of your
  385.     system.  There is no standard or any restriction on what the
  386.     Drive or Home Directory of the board must be, but the
  387.     FILE NAME must be one of those indicated above.
  388.  
  389.  
  390.  
  391.     Comport 1 or 2 can be used.  Comport 3 or 4  should work.
  392.     Fish Sub runs well on 38400.  This door game also does its
  393.     carrier checking.
  394.  
  395.  
  396.     Example configuration file for single line setup.
  397.  
  398.     File name is FISHSUB.CFG
  399.  
  400.  1                           <- Comport #.
  401.  Bensalem BBS                <- Name of your BBS.
  402.  Jim                         <- SysOp first name.
  403.  Toomes                      <- SysOp last name.
  404.  NONE                        <- 19200 or 38400 if dte locked, or NONE.
  405.  C:\WILDCAT\CALLINFO.BBS     <- Complete path to callinfo file.
  406.  C:\WILDCAT\BULL\BULL30.BBS  <- Complete path to scoring file or NONE.
  407.  W2                          <- BBS Type.
  408.  
  409.     Notice the Upper Case.
  410.  
  411.  
  412.     Example configuration file for multi node setup.
  413.  
  414.     File name is FISHSUB1.CFG
  415.  
  416.  1                           <- Comport #.
  417.  Bensalem BBS                <- Name of your BBS.
  418.  Jim                         <- SysOp first name.
  419.  Toomes                      <- SysOp last name.
  420.  NONE                        <- 19200 or 38400 if dte locked, or NONE.
  421.  C:\WILDCAT\NODE1\CALLINFO.BBS <- Complete path to callinfo file.
  422.  C:\WILDCAT\BULL\BULL30.BBS  <- Complete path to scoring file or NONE.
  423.  W2                          <- BBS Type.
  424.  
  425.  
  426.     File name is FISHSUB2.CFG
  427.  
  428.  2                           <- Comport #.
  429.  Bensalem BBS                <- Name of your BBS.
  430.  Jim                         <- SysOp first name.
  431.  Toomes                      <- SysOp last name.
  432.  NONE                        <- 19200 or 38400 if dte locked, or NONE.
  433.  C:\WILDCAT\NODE2\CALLINFO.BBS <- Complete path to callinfo file.
  434.  C:\WILDCAT\BULL\BULL30.BBS  <- Complete path to scoring file or NONE.
  435.  W2                          <- BBS Type.
  436.  
  437.  
  438.  
  439.     Example configuration file for WC30 single line setup.
  440.  
  441.     File name is FISHSUB.CFG
  442.  
  443.  1                           <- Comport #.
  444.  Bensalem BBS                <- Name of your BBS.
  445.  Jim                         <- SysOp first name.
  446.  Toomes                      <- SysOp last name.
  447.  NONE                        <- 19200 or 38400 if dte locked or NONE.
  448.  C:\WC30\WCWORK\NODE1\DOOR.SYS  <- Complete path to door.sys file.
  449.  C:\WC30\BULL\BULL30.BBS     <- Complete path to scoring file or NONE.
  450.  GP                          <- BBS Type.
  451.  
  452.     Notice the Upper Case.
  453.  
  454.  
  455.     Example configuration file for WC30 multi node setup.
  456.  
  457.     File name is FISHSUB1.CFG
  458.  
  459.  1                           <- Comport #.
  460.  Bensalem BBS                <- Name of your BBS.
  461.  Jim                         <- SysOp first name.
  462.  Toomes                      <- SysOp last name.
  463.  NONE                        <- 19200 or 38400 if dte locked, or NONE.
  464.  C:\WC30\WCWORK\NODE1\DOOR.SYS  <- Complete path to door.sys file.
  465.  C:\WC30\BULL\BULL30.BBS     <- Complete path to scoring file or NONE.
  466.  GP                          <- BBS Type.
  467.  
  468.  
  469.     File name is FISHSUB2.CFG
  470.  
  471.  2                           <- Comport #.
  472.  Bensalem BBS                <- Name of your BBS.
  473.  Jim                         <- SysOp first name.
  474.  Toomes                      <- SysOp last name.
  475.  NONE                        <- 19200 or 38400 if dte locked, or NONE.
  476.  C:\WC30\WCWORK\NODE2\DOOR.SYS  <- Complete path to door.sys file.
  477.  C:\WC30\BULL\BULL30.BBS     <- Complete path to scoring file or NONE.
  478.  GP                          <- BBS Type.
  479.  
  480.  
  481.  
  482.     Example DOOR1.BAT
  483.  
  484. /*Configuration for single node*/
  485.  ECHO OFF
  486.  CD \WILDCAT\FSUB
  487.  FISHSUB FISHSUB.CFG
  488.  CD \WILDCAT
  489.  CAT.BAT
  490.  
  491.  
  492. /*Configuration for multi node setup*/
  493.  ECHO OFF
  494.  CD \WILDCAT\FSUB
  495.  FISHSUB FISHSUB1.CFG  <- Rename for node1.
  496.  CD \WILDCAT\NODE1
  497.  CAT.BAT
  498.  
  499.  ECHO OFF
  500.  CD \WILDCAT\FSUB
  501.  FISHSUB FISHSUB2.CFG  <- Rename for node2.
  502.  CD \WILDCAT\NODE2
  503.  CAT2.BAT
  504.  
  505.  
  506.  
  507. Example DOOR1.BAT for WC30
  508.  
  509.  ECHO OFF
  510.  CD \WC30\FSUB
  511.  FISHSUB FISHSUB.CFG
  512.  CD \WC30
  513.  CAT.BAT
  514.  
  515.  
  516. /*Configuration for multi node setup*/
  517.  ECHO OFF
  518.  CD \WC30\FSUB
  519.  FISHSUB FISHSUB1.CFG  <- Rename for node1.
  520.  CD \WC30
  521.  CAT.BAT
  522.  
  523.  ECHO OFF
  524.  CD \WC30\FSUB
  525.  FISHSUB FISHSUB2.CFG  <- Rename for node2.
  526.  CD \WC30
  527.  CAT2.BAT
  528.  
  529.  
  530.     Again if you are going to continue to use FISH SUB, please
  531.     fill out the form below.  Make Check or Money Order Payable
  532.     to Jim Toomes.
  533.  
  534.                    "FISH SUB (c)OPYRIGHT 1990-92"
  535. ----------------------------------------------------------------------
  536.                 FISH SUB  VERSION 5.0 REGISTRATION
  537.  
  538. How did you find out about this game?_________________________________
  539.  
  540. ______________________________________________________________________
  541.  
  542. NAME_______________________________ ADDRESS___________________________
  543.  
  544. CITY______________________ STATE______ZIP________VOICE #______________
  545.  
  546. TYPE OF BBS YOU ARE USING_________________________DATA #______________
  547.  
  548. BBS NAME______________________________________________________________
  549.  
  550. COMMENTS______________________________________________________________
  551.  
  552. ______________________________________________________________________
  553.  
  554. CONTRIBUTION OF $_____________ENCLOSED.  Give me support and upgrades!
  555.  
  556. Asking price $15.00 plus $2.50 for shipping and handling.
  557.  
  558. PLEASE CHECK ONE:
  559.  
  560. [ ] I WILL DOWNLOAD MY REGISTERED COPY FROM THE BENSALEM BBS.
  561.  
  562.     Here is my password, date of birth, telephone number, and
  563.     name as I want it to appear on the Bensalem BBS.
  564.     Note:  This information is needed for access to your registered
  565.            copy.
  566.  
  567. Password____________, Date of birth__________.
  568.  
  569. Telephone number_____________, and Name_______________________________
  570.  
  571.  
  572. [ ] SEND MY REGISTERED COPY TO ME VIA MAIL.
  573.  
  574. [ ] SEND THE GAME TO ME ON A 5.25" DISK.
  575.  
  576. [ ] SEND THE GAME TO ME ON A 3.5" DISK.
  577.  
  578. NOTE: All diskettes are DS/DD.
  579.  
  580.  
  581. MAIL TO:  Jim Toomes
  582.           P.O. BOX 1345
  583.           Bensalem, Pa. 19020-9998
  584. ----------------------------------------------------------------------
  585.  
  586.